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1 . INTRODUCTION 

This report documents the vork performed on the Digital 
Ultrasonics Signal Processing System during the previous 
contract year. This report contains the documentation for 
the software generated during the year. 

The use of ultrasonics evaluation techniques in determining 
the existence of flaws in materials has been recognized by 
NASA to be a useful tool in non-destructive testing. The 
potential exist for using ultrasonics to not only detect 
flaws but to identify and classify them as well. 

The hardware configuration illustrated in Figure 1-1 
consists of two main units. A DEC LSI-11 processor running 
under the RT-11 single jotv version 2C-02 operating system, 
controls the scanner hardware and the Ultrasonic unit. A 
DEC PDP-11/45 processor also running under the RT-11, version 
2C-02, operating system, stores, processes and displays the flaw 
data . 


The software developed for the Ultrasonics Evaluation 
System, shown in Figure 1-2, is divided into two categories: 
transducer characterization and flaw classification. Each 
category is divided further into two functional tasks: a 

data acquisition task and a post processor task. The transducer 
characterization data acquisition task (PACT) and the transducer 
characterization post processing task (PEARL) were developed 
under previous contract efforts. ^ The flaw characterization 
data acquisition task, also developed under a previous task,^ 
collects data, compresses it, and writes it to a disk file. The 
data is then processed by the flaw classification post processing 
task which was developed under this contract. 

This document will describe the use and construction of a 
flaw data post processor. 



^PACT/PEARL Program Documentation, 
February 18, 1980. 


Report No. 80-014, 


2 

Final Report, Digital Ultrasonics Signal Processing: 
Primary Ultrasonics Task and Transducer Characterization Use 
and Detailed Description, Report No. 79-070, November 1, 1979. 
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Figure i-2 Ultrasonic Evaluation System Task Organization 
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2. OVERVIEW OF THE FLAW CHARACTERIZATION TASK 

The Ultrasonics Evaluation System^ i^a modular system ^ c' j.tc 

composed of two sets of tasks which interprets the flaw data' il— — ^ 

and allows compensation of the data due to transducer characteristics* 
The transducer characterization task allows the user to deteonine 
the optimal flaw scanning configuration. The flaw characterization 
task acquires^ in a production mode, the flaw data and processes 
it in a post processing mode. 

The real time data acquisition task for flaw data is called 
PUT (Primary Ultrasonics Task). PUT collects the flaw data, 
compresses it, and writes it to a specified disk file. The records 
written are of varying lengths for each flaw point detected. 

Figure 2-1 is a graphical representation of a flaw point recorded 
by the PUT task as written to a disk file. The function of 
the Flaw Data Post Processor (FDPP) is to process this data into 
meaningful information. The characterization may be 
accomplished by transforming the time domain data into frequency 
domain data. The Fourier transform of time domain flaw data 
nay then be processed *-o produce information leading to flaw 
characterization. The problem becomes complex when one realizes 
that many data points compose a flaw data file; the composite 
of these Fourier transforms is shown in Figure 2-2. 

The problem for the FDPP task is to process the composite 
Fourier transforms into a characteristic Fourier transform, as 
displayed in Figure 2-3, characterize the flaw using the 
principle that different flaws yield different characteristic 
Fourier transforms, and present a three dimensional display 
of the flaw. 



Figure 2-1 Time Domain Flaw Data Point 




3 . PROCESSOR CONFIGURATION 

The structure chart depicted in Figure 3-1 graphically 
illustrates the relationship of the modules within the FDPP 
task. Each of the blocks in the chart represents a module 
within the task. Modules called more than once are represented 
as rounded figures in which the module reappears « and calls to 
library routines are represented as blocks with double vertical 
lines. The structure chart is read from top to bottom and left 
to right; modules which appear on top of the chart are executed 
in sequence before those below and modules are executed in 
order from left to right. Curved lines which encompass a group 
of modules indicate that the group of modules may be called 
iteratively within the calling module. A functional description 
of each of the modules depicted in figure 3-1 is provided in 
Appendix A and a source listing is provided in Appendix B. 

3 . 1 Processor Operations 

3.1.1 Initial Operations 

The FDPP task is initiated via the RT-11 Operating System 
RUN Command which is entered at the operator's console. Once 
initiated, the task sets up the interrupt vectors allowing 
unsolicited input from the Tektronix 4002A graphic display 
terminal. Once this function is completed, the FDPP 
task can receive input via the keyboard on the 
Tekrtonix 4002A keyboard. The task then responds by quering 
for a data file from the operator, then attaching and opening the 
specified data file for reading. 

3.1.2 Normal Operations 

Once the data file has been attached, the FDPP task reads 
the file and processes it for classification and characterization 
of the flaw data. It also presents to the operator tutorial displays 
and messages to aid the operator in selecting the functions to 
be executed by the task and displays the results of the 
processing of the flaw data files according to operator's selected 
options. 

The normal execution cycle for the FDPP task is as follows: 

• Clear the screen and present the user with the next 
display. 

• Wait for the operator response. 

• Collect and echo characters as they are input. 
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Figure 3-1. FOPP Structure Chart 


































• Decode and process the Input commands once the operator 
enters them. 

• Read and process the flaw data files specified by the 
operator. 

e Present the results of the processing of the flaw data 
files in the form of plots and displays. 

3.1.3 Termination Operation 

The FDPP task is terminated via an operator selected option 
entered via the Tektronix 4002A keyboard. The termination 
sequence closes the data file used by the task and returns control 
of the console to the RT-11 Operating System and exits. 

3.1.4 I/O Communications 

Once the FDPP task is initiated, I/O Communications with 
the operator is provided through two mediums; the console 
keyboard and the Tektronix 4002A display terminal keyboard. 

The consoled keyboard is supported by library service routines. 

The FDPP task'' per foims all I/O communications between the 
operator and the Tektronix display keyboard through the 
use of a Tektronix I/O processing service routine (TEKMOD) 
which is a module of multiple entry points, each with specific 
I/O functions located in the FDPP task. (Refer to Appendix A 
for a functional description.) On initiating execution of FDPP 
the CSR's and interrupt vectors are set up for subsequent I/O 
through the graphic display terminal. Functions performed by the 
FDPP processor include input of ASCII characters from the Tektronix 
keyboard, output of messages, displays, plots and tutorial 
information to the Tektronix display. 

The FDPP task provides the capability to control and 
communicate with a DEC RK05 disk drive. Files written by the PUT 
data acquisition task are read by the FDPP task and expanded 
fox processing. 
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4. USER'S GUIDE 

The Keyboard Monitor (KMON) is the routine within the RT-11 
Operating System which provides the interface between the 
user and the operating system. The user initiates the 
Flaw Data Post Processor (FDPP) via using the RUN command 
as follows: 

R(UN) FDPP 

the characters enclosed within parenthesis are optional. Once 
the command is entered ^ the FDPP task is initiated and the 
initial display is presented. 

4.1 Data File Selection 


The first display the user will see once the FDPP task 
is initiated is a query for a flaw data file to be read and 
processed. The query displayed on the Tektronix screen is as 
follows; 


ENTER DESIRED FILENAME: 

DK1:XXXXXX.1ND 

The user's response is a flaw data file name generated by the PUT 
data acquisition task. The response input by the user is a 
filename of up to six characters followed by a (period) 

and a three character extension identification. The "DKl:" 
presented by the query indicates that all data files are 
written to the alternate disk unit denoted by DKl: on 

conventional RTll notation and does not need to be echoed 
in the user response. The file name can be from one to six 
alphabetic characters followed by a period. The extension 
identification is three alphabetic characters and may denote 
file type ('.DAT' is the usual denotation for data files in 
RT-11) or it may be used for an extension of the file name. 

4.2 Plot Viewing Angles 

The display depicted in Figure 4-1 illustrates the options 
available to the user for viewing a three dimensional representation 
of the flaw. The user makes the selection by keying in a 
letter designation which controls the orientation of the 
three dimensional display of the flaw. There are four 
standard orientations of the flaw display which the user 
may select or the user may choose to set up his own viewing 
parameters. The first four views differ only in the angle 
they are viewed. All other scaling parameters are the same. 

If the user selects A (The Orthonormal View) the view 
is rotated counter clockwise about the y axis 45 degrees and 
then rotated counter clockwise about the x axis of the 
resulting coordinate system 45 degrees. With the selection of B 
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Figure 4-1 Display of Plot Viewing Options 


(the 10-degree Tilt View) the rotation about the original 
y axis is the same as that of A but the view is only rotated 
10 degrees counter clockwise about the x axis rf the resulting 
coordinate system. If C (Side Profile) is selected, the originol 
y axis is rotated 90 degrees only and with the selection of D 
(Front Profile) no rotation about the axis is performed. 

4.3 Custom Plot Parameters 

With the selection of '£ from the display of Available PLOT 
Viewing Angles depicted in Figure 4-1, the user may specify 
the parameters for displaying the three dimensional representation 
of the flaw. The user is prompted tutorially for the viewing 
parameters with the series of queries illustrated in Figure 4-2. 
The user is presented with the parameter and a format by which 
to enter his value. The parameters XSCALE, YSCALE and 
ZSCALE are the spacing in inches between the points. The 
parameters PHI and THETA are rotation angles in degrees which 
determine the orientation of the three dimensional display 
of the flaw. The value entered for PHI will rotate the view 
counter clockwise about the y axis of the original 
coordinate system and the value entered for THETA will rotate 
the coordinates about the x axis of the resulting coordinate 
system. The values for XREF and YREF are the coordinates in 
inches, relative to the plotter origin, to be used as the 
origin of the figure. These prompts and responses will be 
displayed and entered from the DECWRITER III Console. 

4 . 4 FDPP Control Options 

The main options of the FDPP task are depicted as follows: 
OPTIONS CURRENTLY AVAILABLE: 

A = CHARACTERIZE AND CLASSIFY FLAW 
I = ENTER NEW FILENAME 
J = EXIT THE PROGRAM 

These options are displayed whenever the FDPP task completes the 
processing of a flaw data file and displaying th<« subsequent 
information selected by the user. The following is a description 
of the available options when this display is active 

A * CHARACTERIZE AND CLASSIFY FTAW. 

Selection of this command allows the operator to specify 
a diffc'ront set of parameters fr'r viewinq and classifying 
the flaw data file. This selection will carry the user back 
to the options of Figure 4-1. 

I » ENTER NEW FILENAME 
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Figure 4-2 Prompts for Custom Plot Parameters 


This option enables the user to select another flaw data file 
for processing. On selecting this option the user will be 
queried for a flaw data file name; the procedures governing 
the selection of the file name will be the same as described 
in Section 4.2. 

J = EXIT THE PROGRAM 

Selection of this option terminates the Flaw Data Post *'rocessor 
task and returns control to the RT-11 Operating System. 

4 . 5 Three Dimensional Display 

Once the operator selects the data file to process* the 
FDPP task processes the file and generates the three 
dimensional representation of the flaw illustrated in Figures 4-3 
and 4-4. The view presented in Figure 4-3 is a three dimensional 
plot where the operator has selected the A option from the display 
depicted in Figure 4-1. The view presented in Figure 4-4 illustrates 
output of the B option from the same display. The plot title 
information from the display is taken from the flaw data file* 
and operator selections made prior to generating the display. The 
parameters PHI and THETA are the rotations of the display in degrees 
described in section 4.3. The values X-LENGTH and Y-LENGTH 
are the lengths in milli-inches of scans in the x and y direction 
recorded by the data acquisition task PUT on the file. The 
parameters TRANSDUCER and SAMPLE are user identification 
symbols for the transducer used for collecting the data and 
the sample material respectively. Both these parameters are 
also recorded on the flaw data file. ALTITUDE is the height 
of the transducer above the sample material when the data was 
recorded . 
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APPENDIX A 


FDPP MODULE FUNCTIONAL DESCRIPTIONS 


Nodule: CALC-Calculation routine 


Language ? FORTRAN 
Called By; PGEN, FLWCHR 
Calling Sequence: CALL CALC 


External References: Conunon Blocks 

EXDCOM 

FCCOM 

PEXCOM 

FORIER 


External 

CENTR 

FT 

INT 

PEXF 

SEARCH 


References: Subroutines 

Center contents of the data buffer 
Take the Fourier transform 
Interpolation routine 
Read data from the disc and expand it 
Search the expanded data buffer for the maximum value 


Functional Description: 

CALC performs the calculations on the data points in the file 
according to which function has been selected. The module 
first converts negative coordinates to positive values and 
validates the point (i.e., account for any deficiencies 
in a point location). Once a point is validated, one of two 
functions is performed. If flaw characterization is being 
performed the data buffer is searchea for the maximum intensity 
of the signal returned from the flaw for each point. 


If flaw classification is being performed, the module 
generates the Fourier transform of the point in the time 
domain. The routine cycles through all the data points and 
generates the Fourier transform for each and generates 
a composite Fourier transform for the flaw. This process 
amplifies trends and minimizes noise fluctuations. 


Module: CENTR Shifts data in the buffer 

Language ; FORTRAN 
Called by: CALC 

Calling Sequence: CALL CENTR (IVAR, IDIFF) 

IVAR - 0: additive Centering 

1 : Subtractive Centering 

IDIFF - The number of elements to shift in 
I the buffer 

External references: Common Blocks 

EXDCOM 

Functional Description: 

CENTR logically shifts the elements in the data buffer 
representing a flaw point, in either direction. 


Module: CNTRL System Control module 

Language: MACRO-11 

Called by: FORMAT 

Calling Sequence: CALL CNTRL 

External References: Common Blocks 

EXDCOM 

FCCOM 

PEXCOM 

TEKCOM 

External References: Subroutines 

CHOUT Output a text string on Tektronix 

CUSTOM Set up parameters for 3-D plots 

ERASE Erases Tektronix screen 

FCL05E Closes data file 

FOP Opens data file 

FORGEN Generates the number of points and lines for 3-D 

plots 

HOME Homes cursor on terminal 

PEXF Processes the packed data file 

Functional Description: 

CNTRL displays menu options, solicits and accepts input 
from the operator. On initial execution of the module, it 
initializes system parameters, reads and unpacks selected data 
files, and automatically classifies and characterizes the 
flaw. CNTRL acts as the operator interface for the FORMAT task. 


Module: CUSTOM - Set customized parameters for three dimensional 

display. 


Language : FORTRAN 

Called by: CNTRL 

Calling Sequence: CALL CUSTOM 

External References: Common Blocks 

FCCOM 

Function Description 

The FORMAT task list a number of viewing options for 
operator selection to represent the flaw in three dimensional 
display. If none of these views are chosen, the operator may 
select his own viewing angle. CUSTOM module will tutorially 
prompt the operator for plot parameters which the three 
dimensional plot is to be displayed. 


Module: FCLOSE - Closes data file 


Language : FORTRAN 

Called by: CNTRL 

Calling Sequence: CALL FCLOSE 

External References: 

CLOSE - Closes the specified logical unit 
(FORTRAN library routine) 

Functional Description 

FCLOSE closes the packed data file once the task has 
completed its processing of the file data. 


Module: FILTER 


Language: FORTRAN Noise filtering routine 

Called by: FLWCHR 

Calling Sequence: CALL FILTER 

External References: Conunon Blocks 

FCCOM 

Functional Description 

FILTER reduces noise peaks to background level and brings 
signal nulls up to the surrounding signals level. A signal 
is a non-zero value two or more index points long. The 
routine scans the array in ascending order until it encounters 
a non-zero value, and looks ahead to the next value. If 
the next value is also non-zero, the scan assuities a "signal 
state" or if the next value returned to zero, the point is 
discarded as noise. The function operates in a complementary 
fashion when it is in a "signal state" and encounters a signal 
null (zero value). 


Module: FLWCHR Flaw Characterization routine 

Language : FORTRAN 

Called by: FORMAT 

Calling Sequence: CALL FLWCHR 

External References: Common Blocks 

EXDCOM 

FCCOM 

PEXCOM 

External References : Subroutines 

CALC Calculation routine 

FILTER Filters out "noise" in flaw data 

PSXF Read and process a record from packed data file 

PGEN Generate Fourier transforms 

PL0T3D Generate three dimensional plots 

Functional Description 

FLWCHR process the flaw data in the time domain and generates 
a three dimensional representation of the flaw. The routine 
cycles through all data points in the file and calculates the 
peak intensity for each point. The result is then filtered 
and plotted. 
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Module : FLWCLS 


Language : FORTRAN 

Called by: FORMAT 

Calling Sequence: CALL FLWCLS 


External References: Common Blocks 

FCCOM 

PEXCOM 

FORIER 


External 

CHOUTS 

ERASE 

FLWDEF 

FSDF 

HOME 

LENGTH 

PEXF 

PGEN 


References : Subroutines 

Print normal size character strings 
Erase Tektronix screen 
Comparison of flaw data 

Search the characteristic FFT array for the maximum 
value 

Homes the cursor on terminal 
Determine the length of the flaw 

Read and process a record from the packed data file 
Generate Fourier transform 


Functional Description 

FLWCLS processes the selected flaw data file and classifies 
it. It initializes the data file by positioning at the 
beginning of the flaw data, generates a characteristic Fourier 
transform of the flaw and classifies it; all processing is 
performed in the frequency domain. The generated result is 
used to correlate the flaw data with previous stored flaw data. 


Module: FLWDEF - Defines the flaw 

Language : FORTRAN 

Called by: FLWCLS 

Calling Sequence: CALL FLWDEF 

External R«^ferences: Common Blocks 

FCCOM 

External References: Subroutines 

NNS - Correlation of flaw data 

Functional Description 

FLWDEF classifies uhe flaw according to the results of the 
correlation of the data processed. If the flaw is classified 
as a known flaw where its data matches a previously stored 
flaw, it is defined. If the data does not match, then its 
parameters are retained for future comparisons. 




Module: FNAM - Pile name input routine 

Language : MACRO- 11 

Called by: FOP 

Calling Sequence: CALL FNAM 

External References: Subroutines 

TEKCOM 

ICHBUF 

External References: Subroutines 

CHOUT Writes characters to Tektronix 

CRLF Sends carriage return/line feed 

Functional Description: 

FNAM presents to the operator the following prompt: 


ENTER FILENAME 

The program then accepts a filename in the form NAME. EXT 
where standard length limitations apply. The file is looked 
up on the disk directly and, if it exists, FSTAT is set to 1. 


Module: FOP - Data file operations routine 

Language : FORTRAN 

Called by: CNTRL 

Calling Sequence: CALL FOP 

External References: Conunon Blocks 

FCCOM 

PEXCOM 

External References: Subroutines 

FNAM File name input routine 

ASSIGN Assigns logic unit number to file name (library routine) 
DEFINE Opens the data file and defines the file parameters 
(library routine) 

Functional Description 

FOP drives the modules which solicit a file name, opens it 
and sets it up for I/O. 
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Module: FORGEN ~ Generate the number of points and lines 

Language : FORTRAN 

Called by: CNTRL 

Calling Sequence: CALL FORGEN 

External References: Common Blocks 

PEXCOM 

FCCOM 

Functional Description: 

FORGEN generates the number of lines and the number of points 
in a line for the data file from the coordinates of the scan 
limits. 


Module: FORMAT - main driver 


Language : FORTRAN 

External References: Common Blocks 

FCCOM 


External References: Subroutines 

BELL Ring bell on terminal 

CNTRL User interface module 

FLWCHR Generate three dimensional plots 

FLWCLS Generate characteristics Fourier transforms of flaw 

plots 

LABEL Outputs the header information of flaw characterization 
results 


PAUSE Suspend execution until user input 

TEKIN Enable terminal interrupt 


Functional Description: 

FORMAT drives all of the subroutines in the flaw data post 
processor task. Upon entry, it solicits infoirmation, initializes 
parameters, and opens data files, essential to the execution of 
the task. On subsequent task it calls other modules based 
on operator input. 


Module: FSDF - Searches characteristic fourier transform 

for the peak value 

Language : FORTRAN 

Called by: FLWCLS 

Calling Sequence: CALL FSDF 

External References: Common Blocks 

FORIER 

FCCOM 

Functional Description 

FSDF searches the array DAT which has the values of the 
characteristic Fourier transform for the maximum value and 
and records it and its location. 


Module; FT - calculations routine 

Language : MACRO- 1 1 

Called by: MNS 

Calling Sequence: CALL FT 

External References: Commons 

EXDCOM 

FORIER 


External References: Global Variables 

ACUMHI MFFT hardware resistor 

ACUMLO MFFT hardware resistor 

MWDCT Number of elements to process 

CTABL Control table for Elsytec 

TAD Temporary area address 

LTMP Length of temporary area in bytes 

INVFG Inverse FFT flag 

External References: Subroutines 

FNl Calls Elsytec hardware functions 

CFT Performs forward and inverse FFTs 

CTO Converts for all-real data 

CMCS Calculates magnitudes of complex arrays 

Functional Description 

FT performs the FFT calculations on the raw data. 



Module: IMT - Interpolation routine 

Language : FORTRAN 

Called by: CALC 

Calling Sequence: CALL INT 

External References: Common Blocks 

EXDCOM 

FORIER 

Functional Description : 

The flaw data points consist of records of varying lengths 
from one case to another. INT takes the data points and 
expands the data into a buffer of uniform length interpolating 
for the missing elements. 


Module: ITOA - Converts to ASCII 

Language : FORTRAN 

Called by: LABEL 

Calling Sequence: CALL ITOA (I, lA, N) 

I - the value to be converted 

lA - the ASCII representation 

N - the number of characters to convert 

Functional Description 

ITOA converts up to 5 digit Integer values to ASCII characters. 
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Module: lABEL - Print header information on Tektronix 

Language : FORTRAN 

Called by: FORMAT 

Calling Sequence: CALL LABEL (PHI, THETA) 

PHI - Rotation in degrees about the y-axis of the original 
coordinate system for the three dimensional plot. 

THETA - Rotation in degrees about the x-axls of the resulting 
coordinate system of the PHI rotation for the three 
dimensional plot. 

External References: Subroutines 

CHOUTS Print normal sized character strings 

HOME Homes cursor on terminal 

IPLOT Plot individual points and lines 

ITOA Convert register format numbers to ASCII 

PRTH Print horizontal label 

Functional Description : 

L^3EL displays titles, header Information and processed Information 
on the Tektronix screen based on file Inf Cyzmatlon , user input, and 
results of the flaw characterization processing of the task. 
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Hodulct LENTGI - R«turn th« length of the flaw 

s 

H Language t FORTRAN 

H Called byt FLWCLS 

b; Calling Sequence t CALL LENGTH 

I External References: Common Blocks 

'I! FORIER 

I' FCCOM 

r Functional Description 


LENGTH determines the length of the flaw. The length is defined 

as three decibels above the average of the last ten 

valuea of the arrav contalnlna the characteristic Fourier transform. 



Module t NNS - Correlation Routine 

Language: FORTRAN 

Called by: FLWDEF 

Calling Sequence: Call NNS (IREF, IC, IFLAW, NUM) 

IREF - Will contain one of two values. The peak amplitude 
of the characteristic Forier transform or the 
frequency shift of the peak amplitude of the 
characteristics Forier transform. 

IC - Refers to which value is IREF. 

1. The frequency shift of the peak amplitude. 

2. The peak amplitude. 

IFLAW - The flaws which most closely match the characteristics 
of the flaw. 

NUM - The number of flaws which closely match the characteristics 
of the given flaw. 

Functional Description : 

NNS performs a nearest neighbor approximation of the current flaw 
and the flaw data table. 


Modiilet PAUSE • Pause for operator input 

Langxiage : MACRO- 1 1 

Called by: FOR»«AT ' 

Calling Sequence: CALL PAUSE 

External References: Common Blocks 

TEKCOM 

Functional Description 

PAUSE suspends execution of the task until the operator keys 
in an entry from the Tektronix terminal. 


Module: PEXF - Expand the next data point 
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Language: MhCRO»ll | 

Called by: CNTRL > 

Calling Sequence: CALL PEXF | 

External References: Conroon Blocks 

FCCOM I 

PEXCOM ^ 

EXOCOM I 

» 

1 

External References : ! 

SREAO - Read compressed data file , I 


Functional Description: 

When PEXF has been called a data file has been opened. After 
compressed data has been read into the data buffer DBUF, PEXF 
expands the points into the buffer IBUF in byte packed form. 
The values found in point headers and scan headers will be 
transferred to the appropriate common locations. 




Module: PGEM - Driver for the calculation routines 

Language ; FORTRAN 
Called by: FLWCLS 

Calling Sequence: CALL PGEN 

External References: Common Blocks 

FCCOM 

EXDCOM 

PEXCOM 

External References: Subroutines 

CALC - Calculation routine 

Functional Description 

PGEN acts as a driver for the calculation routines. It cycles 
through each point of each line to generate the characteristic 
Fourier transform. 


Module: PL0T3D - Displays a three dimensional representation of the 

flaw. 


Language: FORTRAN 

Called by: FLWCHR 

Calling Sequence: CALL PL0T30 (lYXYZ, XDATA, ZOATA, XSCALE, 

YSCALE, ZSCALE, MLINE, NPNTS, PHI, THETA, 
XREF, YREF, XLENGTH) 

(A description of the calling arguments is 
carried in the functional description.) 

External References: Common Blocks 

FCCOM 

FORIER 

External References: Subroutines 

IPLOT - Plots, points and lines 

Functional Description: 

Masked 3-D Dimensional Plot Program with Rotations 

This routine will accept 3-dimensional data in various forms 
as input, rotate it in 3-space to any angle, and plot the 
projection of the resulting figure on to the xy plane. 

Linear interoplation is used between data points. Those 
lines of a figure which should be hidden by a previous line 
are masked. 

The masking technique used by this routine is based on two 
premises — 

Lines in the foreground (positive Z direction) 
are plotted before lines in the background. 

A line or portion of a line is masked (hidden) 
if it lies within the region bounded by 
previously plotted lines. 

Each call to PLOT 3D causes one line of a figure to be plotted. 
Two parameters of the plotter are set on the initial call 
for each figure — 

(PIPI) is the number of plotter increments per inch. 
(NYPI) is the number of increments available across 
the width of the paper (Y-direction) . 

When a new figure is initiated, the plotter origin is set 
at the bottom of the paper by PL0T3D and should not be 
moved until the figure is completed. 

Input parameters - 

(IVXYZ) is a four digit decimal integer which is used to 
select various input/output options. These digits, in 
decreasing order of magnitude, will be referred to as V, 

X, Y, and Z. 


In terms of rotations of axes» the Initial system of axes* 
xyz> is rotated by an angle (PHI) countercloclcwise about the 
y-axis, and the resultant system is labeled the tuv axes. 

The uv axes are then rotated by an angle (THETA) countercloch** 
wise about the t-*axis, and this final system is labeled the 
pqr axes. The plotted figure is the projection of the original 
figure onto the pg-plane. In terms of rotations of coordinates# 
the figure is first rotated by an angle (THETA) cloc)cwlse about 
the x-axis. The resultant figure is then rotated by an angle 
(PHI) clockwise about its y-axis. The plotted figure is the 
warning. Some rotations will alter the foreground/background 
relationships between the lines# and thus the order in which 
they should be plotted. (XREF) and (YREF) are the coordinates# 
in inches# relative to the plotter origin# to be used as the 
origin of the figure. 

(XLENTH) is the length, in inches# to which the plot is 
restricted. Any point which exceeds this limit# or the limits 
of the paper in the y direction (NYPI) # will be set to that 
limit. 


Module: PLTBUF 


Language : FORTRAN 4 

Called by: FLWCLS 1 

Calling Sequence: CALL PLTBUF (IZE) 

IZE » Number of points to be plotted. 

External References: Common Blocks 

FORIER 

IPLOT Plots, points and lines on graphics teanninal 
Functional Description: 

PLTBUF plots the characteristic Fourier transform on the terminal 
along with the labels and axes. 


Module: SEARCH - Return the maximum value in the buffer 


Language : FORTRAN 

Called by: CALC 

Calling Sequence: CALL SEARCH 

External References: Common Blocks 

EXDCOM 

FCCOM 

Functional Description: 

SEARCH cycles through the data buffer IBUF which contains 
the data for each point and returns the maximum value for each. 


Module: SREAO - Reads the data file 


t 


Language : FORTRAN 

Called by: PEXF 

Ca2 ' ing Sequence : CALL SREAD 

External References: Common Blocks 

PEXCOM 

Functional Description : 

SREAD reads the data file in 256 word blocks , four blocks 
at a time. It sets a flag word when the end of the file is 
encountered . 



Module: TEKMOD - Tektronix module 

Language: MACRO-11 

External References: I/O Registers 

CSR for terminal interface 
Read register for terminal interface 

Write register for terminal interface 
Terminal interrupt vector 


This is a group of utility routines which allows the user to 
interface with and control the Tektronix 4002A terminal. The 
following is a brief description of each function within the 
package along with the software interface to the function. 


Entry Point: ALPHA - Puts terminal in alpha mode 

Calling Sequence: Call ALPHA 

Entry Point: ALPHA2 > Puts terminal in large character mode 

Calling Sequence: CALL ALPHA2 

Entry Point: BELL - Rings bell on Tektronix terminal 

Calling Sequence: CALL BELL 

Entry Point: CHOUT - Outputs character strings to the terminal 

Calling Sequence: CALL CHOUT (MBUF) 

Where: MBUF is an array, the first element of which is a 

word containing the character count. 

Entry Point: CR - Sends a carriage return to the terminal. 

Calling Sequence: CALL CR 

Entry Point: CRLF - Sends a carriage return/line feed to 

the terminal 

Calling Sequence: CALL CRLF 

Entry Point: ERASE - Erases screen on Tektronix terminal. 

Calling Sequence: CALL ERASE 

Entry Point: GRIN - Graphic Input Routine 

Calling Sequence: CALL GRIN (lALPHA, IX, lY) 

Where: lALPHA is key pressed to enter coordinate 

IX is X coordinate of graphic crosshair 
lY is Y coordinate of graphic crosshair 


175610 

r/w 

175612 

ro 

175614 

r/w 

175616 

wo 

370 

wo 


Functional Description: 



Entry Point: HOME - H«nes cursor to upper left 

Calling Sequence: Call HONE 

Entry Point: IPLOT - Positions graphic cursor 

Calling Sequence: CALL IPLOT (IX, lY, IPEM) 

/fhere: IX is X coordinate to which cursor is to be moved 
lY is Y coordinate to which cursor is to be moved 
IPEN is pen control 0/1 for Up/Down 

Entry Point: LF - Sends line feed character to terminal 

Calling Sequence: CALL LF 

Entry Point: LFCR - Sends line feed/carriage return to terminal 

Calling Sequence: CALL LFCR 

Entry Point: PRTH • Prints horizontally on terminal 

Calling Sequence: CALL PRTH 

Entry Point: PRTV - Prints vertically on terminal 

Calling Sequence: CALL PRTV 

Entry Point: TEKIN - Enable interrupts from Tektronix terminal 

Calling Sequence: CALL TEKIN 

After TEKIN has been called, unsolicited characters input 
on the terminal are placed in ICHBUF of the common TEKCOM. 

Exceptions are: 


ESCAPE 

(ASCII 

33) 

> Aborts current operation and returns 
system to primary option display. 

CNTRL Q 

(ASCII 

21) 

- Sends 'Stop Scemner' command to 
LSI-11 

CNTRL R 

(ASCII 

22) 

- Sends 'reset* to LSI-11 to reset 
scanner system. 
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